home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / dtype / PCD-DT.lha / PCD-DT / PCD-DT.doc < prev    next >
Text File  |  1998-12-15  |  4KB  |  148 lines
  1. Documentation of pcd.datatype 43.9
  2. ----------------------------------
  3.  
  4.  
  5. Introduction
  6. ------------
  7.  
  8. With the help of the pcd.datatype, your datatype sytem is able to read images
  9. from Photo-CD's.
  10.  
  11. This datatype is Freeware !
  12. Do with it what you want, as long as you do not remove any files from this archive !
  13.  
  14.  
  15. Minumum requirements for pcd.datatype
  16. -------------------------------------
  17.  
  18. * OS 3.0
  19. * MC68020
  20. * A mounted PIPE: handler !!
  21. * The PCD decoder 'pcdtoppm' in your path (included).
  22. * ixemul.library V39 (not included, V41 or higher is recommended).
  23. * render.library V29 or better (included).
  24.  
  25.  
  26. Additionally recommened
  27. -----------------------
  28.  
  29. * CyberGraphX with picture.datatype V43 for 24-bit images.
  30.  
  31.  
  32. Minumum requirements for PCDPrefs
  33. ---------------------------------
  34.  
  35. * OS 3.0
  36. * MC68020
  37. * MUI 3.8
  38.  
  39.  
  40. Installation
  41. ------------
  42.  
  43. Simply click on the 'Install' script.
  44. As the pcd.datatype needs an external decoder, you must select a directory that
  45. is in your path to store the decoder !
  46. The installer will not check your configuration !
  47. You MUST store the decoder 'pcdtoppm' somewhere in your path, otherwise the datatype
  48. will hang up in an endless loop !!
  49.  
  50.  
  51. How does the pcd.datatype work ?
  52. ---------------------------------
  53.  
  54. The pcd.datatype is to small to be a standalone decoder.
  55. Whenever the superclass detects a PCD image, it opens the pcd.datatype.
  56. This launches the external PCD decoder 'pcdtoppm', which redirects its output
  57. to the PIPE-handler. The datatype simply reads the decoded RGB values from the
  58. PIPE handler and stores them in the bitmap.
  59.  
  60.  
  61. Preferences
  62. -----------
  63.  
  64. Mode:
  65.  -> V43 CGX Mode
  66.     Enables V43 CyberGraphX mode.
  67.     If you do not have the picture.datatype 43.x, the datatype will fall back to V40 mode.
  68.  -> V40 AGA Mode
  69.     Truecolor images will be color reduced for AGA.
  70.  
  71. Resolution:
  72. The PCD decoder is able to decompress a PCD image to different resolutions.
  73. The default is 768*512.
  74. The two highest resolutions don't make much sense as you need a fast CPU
  75. and lots of memory !
  76.  
  77. V40 Dithermode:
  78. Enables Floyd-Steinberg dithering (recommended ,1).
  79. Default is 'No dithering' (0).
  80.  
  81. V40 Depth:
  82. Depth to use for color reducing in AGA modes.
  83. Values are from 3 to 8 (default).
  84.  
  85. Currently I only support MUI for the preferences.
  86. If you don't have MUI, you also can adjust the preferences very easy.
  87. The ENV-variable 'DataTypes/pcd.prefs' contains the parameter as a DOS-argument
  88. with the template 'MODE/A/N,RESOLUTION/A/N,DITHER/A/N,DEPTH/A/N'.
  89. You can change the settings anytime either by using the 'SetEnv'-command or by
  90. using a text editor.
  91. A GadTools version of the preferences may follow in the near future.
  92.  
  93.  
  94. History
  95. -------
  96.  
  97. 01-Dec-97  V43.0
  98.    * First public release
  99.  
  100. 04-Dec-97  V43.1
  101.    * Works under non-CyberGraphX systems too.
  102.  
  103. 03-Mar-98  V43.2
  104.     * Datatype is now able to reduce colors of 24-bit images with the render.library.
  105.    * Added MUI preferences (no GadTools version, I'm too lazy for it).
  106.    * Added NewIcons to the archive.
  107.  
  108. 09-Mar-98  V43.3
  109.    * Preferences' resolution is now a cycle gadget with text.
  110.  
  111. 17-Mar-98  V43.4
  112.    * Improved method handling.
  113.  
  114. 18-Mar-98  V43.5
  115.    * Shortened file size.
  116.    * More error handling.
  117.  
  118. 09-Apr-98  V43.6
  119.    * Added render.library to archive.
  120.    * Ops ! Forgot, that datatypes requires ixemul.library. Sorry !
  121.  
  122. 20-Jul-98  V43.7
  123.    * Included new render.library 29.0.
  124.      PCD-Datatype new requires this new version.
  125.  
  126. 20-Oct-98  V43.9
  127.    * Changed flags in memory allocation, so it can be used with VMM (Virtual Memory Manager).
  128.    * Included source code in C++.
  129.    * Corrected the DOS template for prefs.
  130.    * Improved libinit.
  131.  
  132.  
  133. Credits
  134. -------
  135.  
  136. Timm S. Müller for the render.library.
  137.  
  138.  
  139. Author
  140. ------
  141.  
  142. Feel free to contact me for comments, critics or bug reports !
  143.  
  144. Name:     Achim Stegemann
  145. Email:    astegema@ix.urz.uni-heidelberg.de
  146. Internet: http://www.rzuser.uni-heidelberg.de/~astegema
  147.  
  148.